home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / dino / readme < prev   
Encoding:
Text File  |  1994-10-30  |  5.6 KB  |  129 lines
  1. INTRODUCTION:
  2.  
  3.     Welcome to DINO.  This file will (hopefully) serve as enough of an
  4. introduction to DINO to get you started.  You may already have an
  5. installed copy of DINO; if that is true for you, you can skip the
  6. INSTALLATION section.
  7.  
  8.     Please bear with us, this is educational software.  That means
  9. that there will probably be bugs in the compiler.  Feel free to
  10. contact us with any questions or bug reports.  Your feedback is
  11. essential if we are to really be able to correct problems in the
  12. compiler.
  13.  
  14.  
  15. WHAT IS DINO:
  16.  
  17.     DINO is a language for programming numerical applications on
  18. distributed memory parallel machines.  DINO provides the user with a
  19. high level paradigm consisting of a virtual machine, a simple method
  20. for distributing regular data structures across that machine, a simple
  21. parallel execution model, and high level communication primitives.
  22. This first version of DINO only supports single limited sized virtual
  23. machines and regular data.  Future versions should be much broader in
  24. scope.  This version will run on the Intel hypercubes, their simulators,
  25. and a network of sun work stations (using PVM, which you must obtain
  26. separately).
  27.  
  28.     More information about DINO generally can be found in the DINO Users
  29. Manual, described below, or in the September 1991 issue of the Journal
  30. of Parallel and Distributed Computing.
  31.  
  32.  
  33. DOCUMENTATION:
  34.  
  35.     There is an extensive DINO user's manual in the doc directory.  It
  36. is in LaTeX format.  To produce a "dvi" file, type "make" in that
  37. directory, then use your local output program (e.g., dvips) to print
  38. it.  It is about 125 pages, so be patient.  The manual contains an
  39. informal introduction to DINO, a formal description of the language,
  40. many examples, a section on how to set up your defaults to use DINO,
  41. and a section on installing DINO.
  42.  
  43.  
  44.  
  45. INSTALLATION NOTES:
  46.  
  47.     Most of the manual section on installing DINO is obsolete.
  48. There is now an Automated Installation Tool included with the DINO
  49. distribution.  Just make sure that you are in the top level directory
  50. of DINO (this directory) and type "install".  The Automated Installer
  51. will ask you (a large number of) questions, and then do the installation.
  52.  
  53.     The "install" program referred to above is one that comes with
  54. DINO.  If your path does not have a "." at the beginning, it may
  55. be necessary for you to type "./install" to invoke the DINO install
  56. program instead of the standard unix "install".
  57.  
  58.     The Automated Installer just does a plain vanilla installation
  59. (for a large number of machine combinations and types).  If you want
  60. to take advantage of DINO's fancier options (for installation), you
  61. will have to do so manually.  We suggest that you use the Automated
  62. Installer to set up the initial installation and then modify it by
  63. hand.  However, if you want to install DINO from scratch, the details
  64. in the Installation Section of the Manual on how all the configuration
  65. files work are still correct.  That Section should also be consulted
  66. if you wish to modify the automatic installation.
  67.  
  68.     The Automated Installer can also be used to update DINO if you
  69. have a newer tape.  Just proceed as if you were doing an initial
  70. installation.  The Automated Installer should not modify any of your
  71. configuration files.
  72.  
  73.     You will have to provide the automated installer with a fair
  74. amount of information for it to work correctly, such as names of
  75. directories where you want DINO installed on any remote parallel
  76. machines, etc.  The one thing that you should prepare in advance is
  77. that DINO can only install the back end(s) of the compiler (the part
  78. that runs on the parallel machine) if there is a login on that machine
  79. which has write access to the necessary directories and that trusts
  80. the user doing the installation on the sun (the permissions in the
  81. ".rhosts" file are correct).  If this is not the case, you will have
  82. to do part of the installation manually.
  83.  
  84.     If you have an iPSC2 that has files cross-mounted with nfs, DINO
  85. can take advantage of this fact in two situations: (1) If user's home
  86. directories are cross-mounted, DINO will not have to copy intermediate
  87. programs to the cube; (2) if the installation directory for DINO is
  88. cross-mounted, DINO will not have to copy the back-end part of the
  89. compiler over to the cube.  The DINO installation program will ask
  90. about these situations.
  91.  
  92.  
  93. USER NOTES:
  94.  
  95.     To make use of DINO, you must have an "ARCHTYPE" environment
  96. variable defined (using the standard sun convention) and you have to
  97. make an addition to your path.  This is more complicated than it might
  98. seem, because you have to do the same thing on every remote parallel
  99. machine you are using as well.  See the DINO user's manual for
  100. information on this.
  101.  
  102.     There is an include file with the predefined mapping functions in
  103. it. To use this file, put:
  104.  
  105.         #include "dino.h"
  106.  
  107. at the top of your program.  Then you invoke the DINO compiler with:
  108.  
  109.         dino <filename>
  110.  
  111. Typing "dino -help" gives you a list of all the dino options.  These
  112. are explained in the DINO user's manual.
  113.  
  114.     There are at least a dozen known compiler bugs. a list of these
  115. can be found in the DINO user's manual.  There are probably more than
  116. a dozen unknown compiler bugs.  These can be found by using DINO.
  117. Please share any bugs with us, in addition to letting us know what you
  118. like and don't like about DINO.  We can be reached by email at
  119. "dino@cs.colorado.edu".
  120.  
  121.                                             Betty
  122.                                             Bob
  123.                                             Matt
  124.                                             Rich
  125.                                             Tom
  126.  
  127.                                             The DINO "compiler lizards"
  128.  
  129.